api/user/availability/{userID} (Get)

Get	api/user/availability/{userID}

In This Topic

Resource Path: /sites/{company-id}/api/user/availability/{userID}

Uri: https://secure.ontime360.com/sites/{company-id}/api/user/availability/{userID}

Description

Retrieves the current availability of a given User.

Parameters

Name	Description	Data Type
userID	The unique identifier of a User as a Guid.	string

200 Response

The response body is of type UserAvailability.

Returns a comprehensive UserAvailability object.

UserAvailability

Represents a comprehensive UserAvailability record within the OnTime API.

ID : string

The unique identifier for this UserAvailability record.

UserID : string

The unique Guid identifier referencing the relative User record assigned to this UserAvailability.

IsAvailable : boolean

Indicates if the User is currently available as a driver.

CurrentStatus : string

A description of the User's status while they are available.

LastStatusChange : string

The date of when the most-recent availability status update was made by the User.

Latitude : number

The geographic latitude coordinate of where the most-recent availability status update was made by the User.

Longitude : number

The geographic longitude coordinate where the most-recent availability status update was made by the User.

NextAvailabilityChange : string

The approximate date of when the next availability status update will be made by the User.

Fault Responses

Fault	Description
400	Request was improperly formatted, contained invalid data, or contained incorrect values. See response body for more information.
401	Authorization key is invalid or no longer exists.
403	Authorization key does not have permission to perform this action, or does not have permission to access the requested data. See response body for more information.